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Introduction 


The  CenterView  program  allows  users  to  easily  retrieve 
commonly  requested  data  from  the  Center  for  Seismic 
Studies  databases.  After  retrieving  the  data  from  the 
database,  the  user  may  process  it  in  many  ways, 
including  dumping  to  flat  files,  sending  to  other  programs 
via  interprocess  communication,  sorting,  resegmenting, 
etc. 

In  a  typical  CenterView  query,  the  user  specifies  a  series 
of  constraints  which  provide  enough  information  for 
CenterView  to  form  a  query.  CenterView  has  two 
methods  of  operation.  The  first  method  is  an  X  windows 
based  interface,  and  the  second  is  a  batch  mode,  which 
allows  the  user  to  perform  a  subset  of  the  queries  using  a 
simple  command  language.  This  tutorial  describes  the 
basic  features  of  the  X  Windows  interface  to  CenterView, 
and  provides  a  tour  through  the  most  common  queries. 

This  tutorial  assumes  that  you  are  running  CenterView  on 
machines  at  the  Center  for  Seismic  Studies  and  that  the 
database  itself  will  also  be  at  the  Center.  If  this  is  not  the 
case,  then  some  of  the  exercises  may  be  inaccurate.  This 
tutorial  also  assumes  that  the  user  is  familiar  with  X 
windows  and  Unix. 
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Conventions 

CenterView  follows  the  conventions  of  the  Motif  user-interface 
environment  The  following  conventions  will  help  you  navigate 
through  CenterView  and  this  tutorial. 


Mouse 

•  Only  the  left  button  is  used  in  CenterView.  To  initiate  an 
action  with  the  mouse,  place  the  pointer  where  you  want  the 
action  to  take  place,  then  quickly  press  and  release  the  left 
mouse  button.  This  is  called  “clicking”. 

•  “Point  the  mouse”  means  without  pressing  the  left  button 
move  the  mouse  until  the  arrow  (pointer)  is  over  the  desired 
location. 

•  “Drag”  means  press  the  left  button  over  the  text,  drag  the 
cursor  until  the  text  becomes  highlighted,  then  release  the 
button. 

•  When  the  mouse  pointer  changes  to  a  watch  icon,  CenterV ie w 
is  busy  and  no  action  can  be  taken  in  the  Main  window. 

Menus/Windows 

CenterView  menus  are  located  above  the  main  window.  To  see 

the  contents  of  a  menu,  click  on  the  menu  name.  To  select  an  item 

from  the  menu,  drag  the  mouse  to  the  item  and  click. 


|  File  |  Query  View  Options  Customize 

Choose  Default  Server 

Ctrl+d 

Connect  To  Agent 

Load  File 

Ctrl+I 

Load  Table  Descriptions 

Upload  Data 

Exit 

Ctri+x 

Conventions 


Many  different  windows  are  displayed  in  CenterView.  The 
windows  contain  various  buttons  defined  as: 


Done 

Cancel 

Select  All 


Proceeds  to  the  next  window  after  applying 
any  changes. 

Aborts  the  current  function  and  returns  to 
the  previous  window. 

Selects  all  of  the  items  in  the  list  To  select 
individual  entries,  click  on  the  selection. 


DeSelect  All  Deselects  all  of  the  items  in  the  list.  To 
deselect  individual  entries,  click  on  the 
selection. 


Hide  Hide  a  window,  taking  no  action. 

Dismiss  Removes  a  dialog  window. 


Text  Fields 

A  simple  text  field  consists  of  a  label  followed  by  one  input  box: 


Database  Accounts:  j 


Generally,  one  or  more  values,  separated  by  commas  can  be 
entered  into  a  simple  text  field.  However,  some  simple  text  fields 
such  as  the  User  Event  File  field  can  only  take  one  value. 

Range  text  fields  contain  two  input  boxes  separated  by  “to”: 


Event  Depth: 


For  these  text  fields  the  user  should  supply  a  range,  i.e.,  enter  a 
lower  bound  for  the  range  in  the  left  input  box  and  an  upper 
bound  in  the  right  input  box.  It  is  not  necessary  to  supply  both 
upper  and  lower  bounds: 


Phase  Type  Window: 
Velocity  Window: 


to 


to 


To  enter  text  in  an  input  box: 

Move  the  mouse  to  the  input  box  and  click  the  left  button.  The 
border  around  the  input  box  becomes  darker,  indicating  that  it  is 
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selected.  Type  in  the  appropriate  text.  Text  fields  are  generally 
case-sensitive,  although  there  are  some  fields  where  case  is 
unimportant,  e.g.,  the  Database  Accounts  field. 

Use  the  keyboard  to  move  quickly  through  multiple  input  boxes. 
To  move  forward,  prep,j  the  <Tab>  or  <Return>  keys.  To  move 
to  the  previous  input  box,  simultaneously  press  the  <Shift>  and 
<Tab>  keys. 

To  delete  text  from  an  input  box: 

Click  the  left  mouse  button  at  the  beginning  of  the  text  and  drag 
it  to  the  end  of  the  text  segment  or  double-click  to  select  the 
whole  text  entry.  Press  the  <Delete>  key  to  remove  the 
highlighted  text.  You  may  also  use  the  <BackSpace>  key  to 
delete  the  text  letter  by  letter. 


To  move  the  cursor  within  an  input  box: 

Move  the  mouse  to  the  position  where  you  would  like  the  cursor 
and  press  the  left  mouse  button.  Use  the  left  and  right  arrow  keys 
to  move  the  cursor. 

NOTE:  Input  boxes  retain  their  values.  Values  previously  entered 
will  be  displayed  as  the  initial  value.  Throughout  this  tutorial 
there  are  examples  where  it  will  be  necessary  to  delete  these 
initial  values  from  input  boxes. 
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Help 

Center  View  provides  two  types  of  help: 

(1)  Every  field  can  be  described  by  a  popup  Help  window.  To 
display  this  help,  delete  the  contents  of  the  input  box  and 
press  the  <F1>  key.  On  some  systems  the  <Help>  key 
should  be  used  in  place  of  the  <F1>  key.  In  the  example 
below,  a  description  for  the  Event  Magnitude  field  has  been 
activated.  Remove  this  help  window  by  clicking  the 
Dismiss  button. 


(2)  A  list  of  valid  choices  may  be  available  for  some  fields.  To 
display  this  help,  type  text  in  the  field  and  press  the  <F1> 
key.  If  this  help  is  unavailable  for  the  specified  field,  then  the 
field’s  description  will  be  displayed  instead.  The  text  in  a 
field  determines  what  will  be  shown  in  the  list.  If  one  or  more 
wildcard  characters  (*  or?)  are  present  in  the  field,  then  the 
contents  of  the  box  will  be  treated  as  a  pattern.  In  this  case, 
only  options  matching  the  pattern  will  be  displayed.  The  * 
character  matches  any  number  of  characters,  while  the  ? 
character  matches  exactly  one  character  (similar  in  behavior 
to  *  and  ?  in  most  shells). 
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In  this  example,  E*  was  typed  in  the  Database  Accounts  field 
and  the  <F1>  key  was  pressed.  Select  from  the  list  of 
displayed  accounts  and  click  the  Done  button  to  enter  your 
selection  in  the  field.. 


Account  Database  Server  First  Fear  Last  rear  I  Stations  •  Arrlvi 


□  EUSEQK  HUGO 

O  EUSEXP  HUGO 

□  EVENTS  HUGO 

□  EXPLOSION  HUGO 
Q  EXPLO_HIST  HUGO 


1962033 

1986031 

55 

1961344 

1966210 

29 

1993110 

1945197 

1992269 

864 

1957207 

1902360 

45 
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Initialization 

The  instructions  below  describe  how  to  start  Center  View  on  machines 
at  the  Center.  For  this  tutorial,  we  will  run  CenterView  on  sol.css.gov, 
which  is  one  of  the  more  powerful  machines  at  the  Center  and  is 
intended  for  research  and  data  retrieval. 


✓  To  give  sol  permission  to  see  the  display  on  your  local  machine, 
type: 

xhost  +sol.css.gov 


^  To  log  into  sol  from  a  UNIX  system,  type: 

rlogin  sol.css.gov  -1  username 

where  username  is  your  account  name  at  the  Center.  If  you  do  not 
have  an  at  count  at  the  Center,  contact  the  Center’s  system 
administrator  at  (703)  276-7900,  or  you  can  use  the  CenterView  e- 
mail  interface.  For  information  on  this  service,  send  e-mail  to 
cssinfo@seismo.css.gov,  with  the  subject  as  “help”. 

✓  To  specify  that  CenterView  should  be  displayed  on  your  local 
machine,  type: 

setenv  DISPLAY  machine . xxx .  yyy : 0 

where  machine .  xxx  .  yyy  is  the  complete  internet  address  of  your 
local  machine.  If  you  are  running  a  shell  other  than  csh,  you  may 
have  to  use  a  different  command  to  set  your  display.  For  example,  if 
you  are  using  ksh  you  will  have  to  type: 

DISPLAY=machine . xxx . yyy : 0 

followed  by: 

export  DISPLAY 

If  you  are  using  a  different  shell,  check  the  manpage  for  the  shell  to 
get  help  on  setting  environment  variables. 

To  use  CenterView  in  conjunction  with  other  programs,  e.g., 
geotool  or  Map,  you  will  have  to  start  ISIS  and  the  CommAgent. 
Appendix  B  of  this  tutorial  explains  the  steps  necessary  for  running 
CenterView  with  other  programs.  Examples  arc  also  provided  later  ;n 
this  tutorial. 


✓  Before  you  start  CenterView,  you  must  set  the  ROOTPATH 
environment  variable. 

CenterView  reads  a  number  of  configuration  files  at  start  time.  These 
files  are  located  in  th"  directory  /nmrd/rcl.  Therefore,  it  is  necessary 
to  set  the  ROOTPATH  environment  variable  to  /nmrd/rel  (See  the 
notes  for  setting  the  DISPLAY  environment  variable). 
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✓  Make  sure  that  you  are  in  a  writable  directory: 

During  this  tutorial  we  will  be  using  CenterView  to  dump  data  to 
disk.  To  simplify  this  you  should  be  in  a  writable  directory.  If  you  are 
not  sure  what  directory  you  are  in,  you  should  return  to  your  home 
directory  by  typing: 
cd 


1/  To  start  CenterView,  type: 

CenterView 

Several  messages  will  appear  indicating  that  several  startup  files  have 
been  read.  If  there  are  errors  in  opening  any  of  these  files,  it  is  likely 
that  your  ROOTPATH  environment  variable  is  not  set  correctly  (see 
above). 
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The  Main  Window 

Once  the  Scheme  extensions  have  been  initialized,  the  main 
CenterView  window  is  displayed.  If  CenterView  is  unable  to  initialize 
interprocess  communications,  a  “No  Agent  Connection”  message  box 
will  also  be  displayed.  This  message  indicates  that  ISIS  and  the 
CommAgent  are  not  currently  running,  and  that  CenterView  will  be 
unable  to  communicate  with  geotool  and  the  Map  program. 


File  Query  View  Options  Customize 


Data  Types 

□  Detection  Parameters 

□  Station  Parameters 

j 

□  Event  Parameters 

□  Waveforms 

Database  Accounts: 


rn  hiHwiy  nnrntain.nn,  ■ . ... ....... 

t.|  tiiSjSy  v  ;  • '  .  No  Agent 


Conneclion 


Unable  to  initialize  process  communications.  To  establish 
communications,  check  to  see  that  ISIS  and  the  CommAgent 
are  running,  and  choose  Connect  To  Agent  from  the  File  menu. 


t  |Oism)ss| 


Click  the  Dismiss  button  to  close  this  window.  If  you  are  able  to 
resolve  the  problem,  you  may  choose  the  Connect  to 
CommAgent  item  from  the  File  menu,  which  will  display  the 
Connect  to  Agent  window: 


Use  this  window  to  specif''  the  Agent  Name  and  ISIS  Port.  Click  the 
Connect  button  to  initialize  the  specified  process  communications 
or  click  the  Cancel  button  close  the  window  without  connecting  to 
an  agent. 
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Connecting  to  a  Database  Server 

Before  CenterView  can  perform  a  query,  it  must  be  connected  to  a 
database  server.  By  default,  CenterView  connects  to  hugo,  which  is 
the  database  for  the  central  data  repository. 

1.  Choose  Default  Server  from  the  File  menu. 

A  Server  List  window  is  displayed.  This  window  lists  the 
available  database  servers  with  a  brief  description  of  each.  In  the 


example,  the  server  HUGO  has  been  selected. 

Fl  

jfflifnftrtl 

Server 

Description 

OALSVID  CSS 

IMS  Operations  (Arlington,  VA) 

■ 

O  ERLIK  CSS 

❖  HUGO  CSS 

O  SOL  CSS 

IMS  Operations  (Arlington,  VA) 

Central  Data  Repository  (Arlington,  VA) 

Research  (Arlington,  VA) 

- 

rmnlm  : 

1 

2.  Select  HUGO  and  click  the  Done  button. 

The  Database  Accounts  field  specifies  the  accounts  from  which 
data  will  be  retrieved.  One  or  more  accounts  may  be  listed  in  this 
field. 


Unless  otherwise  specified,  all  database  accounts  entered  in  this  field 
arc  expected  to  reside  on  the  database  server  chosen  as  the  default 
server.  If  this  is  not  the  case,  then  (©server-name  may  be  appended  to 
the  account  name.  This  indicates  that  the  account  resides  on  the 
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specified  server. 

You  can  enter  a  Database  Account  in  two  ways: 

a)  Type  the  account  name  in  the  Database  Accounts  field,  or 

b)  Type  *  in  the  Database  Accounts  field  and  press  the  <F1>  key. 

A  Help  window  will  be  displayed.  This  window  lists  the  available 
database  accounts,  provided  that  you  are  connected  to  a  database 
server  at  the  Center.  Use  the  scrollbar  to  view  all  of  the  accounts. 
Select  an  account  name  and  click  the  Done  button.  In  this  example, 
the  GSETT  account  has  been  selected. 


A  Simple  Event  Query 


A  Simple  Event  Query 

This  query  retrieves  event  information  from  a  database.  Later 
examples  will  demonstrate  further  uses  of  the  query  results. 

1.  Click  on  Event  Parameters  under  Data  Types. 

Constraint  Types  are  displayed  for  the  Event  Parameters. 

2.  Click  By  Event  Time  and  By  Event  Magnitude  in  the 
Constraint  Types  list. 

Query  Parameter  fields  are  displayed  for  Event  Time  and  Event 
Magnitude.  Use  these  fields  to  specify  the  values  that  will  be 
used  to  form  the  query. 


File  Query  View  Options  Customize 


_ Data  Types 

□  Detection  Parameters  □  Station  Parameters 
E  Event  Parameters  □  Waveforms 


Database  Accounts: 

JGSETT 

Constraint  Types 

□  By  Event  Author 

□  By  Event  Type 

□  By  Event  Location 

□  By  Geographic/Seismic  Region 

S  By  Event  Magnitude 

□  By  Mb/Ms/MI 

0  By  Event  Time 

□  By  Number  o(  Defining  Phases 

Event  Magnitude: 
Event  Time: 


Query  Parameters 


3.  Enter  4  and  4 . 5  in  the  Event  Magnitude  fields.  Enter  5/1/91 
and  5/3  0/91  in  the  Event  Time  fields. 

This  query  will  retrieve  all  events  that  occurred  between  00:00  on 
May  1,  1991  and  00:00  on  May  30,  1991  that  had  a  mb,  ms,  or  ml 
magnitude  between  4  and  4.5. 

4.  Select  Run  Query  from  the  Query  menu. 

While  the  query  is  running,  CenterView  displays  an  Abort 
window  with  two  options:  Abort  and  Dismiss.  The  Abort  button 
terminates  the  query.  It  is  provided  for  times  when  the  query  is 
taking  longer  than  expected,  or  when  an  error  has  been  noticed 
after  the  query  has  been  started.  The  Dismiss  button  closes  die 
Abort  window  without  terminating  the  query.  The  user  may  then 
further  specify  die  query  constraints  in  die  View  window. 
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The  query  Is  running.  To  terminate  the  query,  press  Abort 
To  remove  this  window  without  terminating  die  query,  press 
Dismiss. 


IjAbort^jDistrilss^ 

If  the  number  of  rows  produced  by  the  query  is  so  large  that  it  would 
impact  the  performance  of  CenterView,  only  a  limited  number  will  be 
displayed.  This  Maximum  is  set  to  200  rows  by  default  In  the  event 
that  CenterView  truncates  the  result  list,  a  window  will  appear 
notifying  you  that  there  are  more  rows  than  are  actually  displayed. 


runcated  Result  Us 


The  result  list  for  this  query  contains  237  rows, 
which  is  too  large  to  fit  in  one  display.  Only  the 
first  200  rows  will  be  displayed. 


|pismiss| 


5.  Click  Dismiss  in  the  Truncated  Result  List  window. 

CenterView  displays  default  columns  from  the  most  significant 
database  tables  involved  in  making  the  query.  For  this  query, 
origin.etoh  (the  origin's  epoch  time  to  human  time),  origin.lat  (the 
origin’s  latitude)  and  origin.lon  (the  origin’s  longitude)  are  displayed. 


You  have  now  completed  your  first  CenterView  query.  In  the  next 
example  we  will  use  the  results  of  this  query. 
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Naming  Queries 

You  can  assign  a  name  to  each  query  for  later  use. 

1.  Click  the  mouse  on  the  text  labeled  Result  List  #1. 


File  Query  View  Data  Download  Options  Send 


Result  List  #ll 


origin. etoh 


origin. lat  origin. Ion 


B  05/01/91  02:57:15.5-26.5042  -177.5178 
B0S/01/91  03:01:02.4  -11.7271  -166.4709 
B  05/01/91  03:06:48.8  42.2588  44.3989 
B  05/01/91  03:38:12.0  42.5092  43.7230 
B  05/01/91  04:39:06.7  -2.0415  120.8861 
B  05/01/91  05:13:37.4  42.5975  43.7733 


Select  All]  IDeselect  All 


You  may  now  use  the  same  methods  described  earlier  for  editing  text 
in  an  input  box  to  change  the  name  of  the  query. 

2.  Enter  the  text  First  Event  Query  into  the  input  box. 


Continuing  a  Query 


Continuing  a  Query 

You  may  continue  using  a  query  by  adding  new  constraints  to  an 
existing  result  list.  For  instance,  a  large  number  of  events  were 
selected  in  the  previous  query.  It  may  be  useful  to  find  all  of  the 
detections  at  a  small  number  of  stations  for  some  subset  of  those 
events. 

For  this  example,  we  will  display  event  and  detection  information  for 
associated  P  phases  at  ARAO,  NRAO  and  FIAO,  for  all  events  in  the 
previous  query. 

1.  In  the  Result  List,  select  Continue  Query  from  the  Query 
menu. 

The  Continue  Query  window  is  displayed.  This  window  is  similar 
to  the  main  CenterView  window  except  it  retains  default 
information  from  the  current  query. 


m 


[Continue  Querya 


File  Query 


Data  Types 


B  Detection  Parameters  O  Station  Parameters 
I  B  Event  Parameters  □  Waveforms 


Database  Accounts:  j 

GSETT@>HUGO 

Constraint  Types 

U  by  uetection  lime 

U  by  oeograpnicibeismic  Megion 

□  By  Event  Author 

□  By  Mb/Ms/MI 

□  By  Event  Location 

B  By  Network/Station/Channel  Code 

□  By  Event  Magnitude 

□  By  Number  of  Defining  Phases 

□  By  Event  Time 

B  By  Phase  Name 

I 


8 


DI 


jEJ 


Query  Parameters 


Detection  Method: 
Network/Station: 
Expand  Networks: 
Channel: 

Initial  Phase: 
Associated  Phase: 


By  Event  Associations  o 


ARAO.NRAO.FIAO 


No  o 
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Continuing  a  Query 


2.  Click  Event  Parameters  and  Detection  Parameters  under 
Data  Types,  as  shown  above,  so  that  they  are  both  highlighted. 
The  Continue  Query  window  will  display  additional  constraint 
types  relating  to  the  Detection  Parameters. 

3.  To  apply  additional  constraints  to  the  query,  click  the  By 
Phase  Name  and  By  Network/Station/Channel  Code 
constraint  types. 

4.  Since  we  are  interested  in  associated  P  phases  at  ARAO, 
NRAO,  FIAO,  type  P  in  the  Associated  Phase  field  and  type 
ARAO ,  NRAO ,  FIAO  in  the  Network/Station  field,  separated  by 
commas. 

5.  In  the  Continue  Query  window,  select  Run  Query  from  the 
Query  menu. 

A  result  list  is  displayed.  Since  there  is  more  than  one  detection 
for  a  given  event,  there  may  be  many  copies  of  the  same  event  in 
the  result  list,  each  with  a  different  detection.  In  general, 
CenterView  displays  all  distinct  combinations  of  results. 


File  Query  View  Data  Download  Options  Send 

Iftetuit  u«  ia 


origin. otoh  origin. lat  origin.  Ion  arrival -ata  arriva  1 .  iphaaa  arrival .atoh 


■  5/1/91 

03:06:40.0 

42.2560 

44.3909 

ARAO 

P 

S/1/91 

03:12:49.0 

B  5/1/91 

03:06:40.8 

42.2588 

44.3989 

NRAO 

P 

5/1/91 

03:12:32.0 

■  5/1/91 

03:30:12.0 

42.5092 

43.7230 

ARAO 

P 

5/1/91 

03:44:11.6 

B  5/1/91 

03:38:12.0 

42.5092 

43.7230 

NRAO 

P 

S/1/91 

03:43:50.1 

■  5/1/91 

05:13:37.4 

42.5975 

43.7733 

ARAO 

P 

5/1/91 

05:19:32.3 

B  S/1/91 

05:13:37.4 

42.5975 

43.7733 

NRAO 

P 

5/1/91 

05:19:14.3 

|SeltclAll|  |Onelect  All] 


We  will  now  explore  some  of  the  uses  for  the  results  of  a  query. 


Displaying  Columns 


Displaying  Columns 

The  Result  List  displays  only  a  few  columns  from  each  database  table 
used  for  the  query.  Often  there  are  other  columns  that  are  of  interest, 
and  CenterView  allows  you  to  display  columns  other  than  or  in 
addition  to  the  default  columns,  and  also  allows  you  to  reorder  them. 
For  this  example  we  will  add  the  column  origin.mb  and  reorder  the 
columns. 


1.  In  the  Result  List  choose  Display  Columns  from  the  View 
menu. 

A  Display  Columns  window  lists  categories  which  can  be 
selected  as  columns.  Scroll  through  the  list  to  see  currently 
selected  categories;  they  are  numbered  by  the  order  in  which 
they  appear  in  the  Result  List.  For  example,  origin.etoh  appears 
as  the  first  column  of  the  Result  List  and  is  numbered  “1”. 


[display  Columns! 


(  1  E  origin,  etoh  origin-time  (human  format)) 


Oorigin.etype 
P  origin. evid 
O  origin. grn 

□  origin. }date 

2  H  origin. lat 

□  origin. lddate 

3  B  origin. Ion 


event  type 
event  id 

geographic  region  number 
julian  date 
estimated  latitude 
load  date 

estimated  longitude 


EC 


[Done|  |Deselect  Au]  [Hide| 


2.  Click  the  Deselect  All  button  in  the  Display  Columns 
window. 

3.  Scroll  to  origin.mb  and  select  it;  it  becomes  #1.  Continue 

selecting  categories  in  the  following  order:  (2)origin.etoh, 
(3)origin.lat,  (4)origin.lon,  (S)arrival.sta, 

(6)arrival.iphase,  and  (7)arrival.etoh. 

4.  Click  the  Done  button  to  apply  the  changes. 

After  a  brief  delay,  CenterView  displays  the  Result  List  in  the 
newly-defined  order. 
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Sorting 


Sorting 

In  addition  to  selecting  the  columns  displayed  as  the  Result  List,  you 
can  reorder  the  rows  by  selecting  columns  to  sort  by.  You  can  also 
specify*  whether  to  sort  the  rows  in  ascending  or  descending  order. 

1.  In  the  Result  List,  choose  Sort  Columns  from  the  View 
menu. 

A  Sort  Columns  window  lists  the  columns  for  sorting.  Selected 
columns  are  numbered  by  the  order  they  appear  in  the  Result  List. 
By  default,  the  rows  are  sorted  in  ascending  order  by 
(l)origin.time,  (2)origin.lat,  (3)origin.lon,  (4)arrival.sta 
(5)arrival.iphase,  and  (6)arrival.time.  NOTE:  The  rows  were  first 
sorted  by  origin.time  but  displayed  in  human  time  because 
origin.etoh  would  sort  the  rows  by  alphabetizing  each  origin.etoh 
string. 


Sort  Direction: 


O  origin. orid 

□  origin. srn 

1  E  origin.time 
O  query 

□  server 

□  site. account 

□  site.deast 


origin  id 

seismic  region  number 
epoch  time 
query  name 
server  name 
site  account 

offset  from  array  reference  (km) 


p: 


]  |Done|  [Deselect  Ail]  |  Hide| 


2.  Click  the  Deselect  All  button  in  the  Sort  Columns  window. 

NOTE:  To  deselect  one  category  at  a  time,  press  the  <Shift>  key 
and  click  on  the  category.) 

3.  Select  column  origin.mb.  It  becomes  #1. 

4.  Continue  selecting  columns,  e.g.,  (2)origin.time, 
(3)arrival.sta,  (4)arrival.iphase. 

5.  Specify  Ascending  or  Descending  in  the  Sort  Direction 
box. 

6.  Click  the  Done  button  to  apply  the  changes. 

After  a  brief  delay,  the  Result  List  is  displayed  in  the  new  order. 
In  this  case,  only  the  first  three  columns  were  necessary  to 
complete  the  sort  (i.e.,  no  two  rows  contain  identical  data  for  ( I ), 
(2),  and  (3),  therefore  it  was  unnecessary  to  select  column  (4)). 
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Closing  Result  List  Windows 

When  doing  more  than  one  query  in  CenterView,  the  screen  can 
become  cluttered  with  windows  from  previous  queries.  These 
windows  can  be  hidden,  with  their  results  retained  for  use  later  in  the 
session. 


1.  In  the  Result  List  window  named  Result  List  #2,  choose  Close 
from  the  File  menu. 

The  window  will  be  removed  from  the  screen. 

2.  In  the  Result  List  window  named  First  Event  Query,  choose 
Close  from  the  file  menu. 

This  window  may  be  hidden  underneath  the  Continue  Query 
window.  If  this  is  the  case,  then  you  may  first  choose  Close  from 
the  File  menu  of  the  Continue  Query  window. 


To  retrieve  a  result  list: 


3.  Choose  Result  List  from  the  View  menu. 

A  list  of  all  the  result  lists  generated  in  this  session  will  be 
displayed 


4.  Choose  First  Event  Query  from  the  list,  and  click  Display. 

The  result  list  from  the  first  query  in  this  tutorial  will  be 
displayed. 

5.  To  remove  the  Results  List  window,  click  Hide. 

This  window  may  be  hidden  underneath  the  First  Event  Query 
result  list  window.  If  this  is  the  case,  then  you  may  first  move  the 
Result  List  window  out  of  the  way  to  expose  die  Results  List 
window,  and  then  click  Hide. 
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Formatting  Bulletins 


Formatting  Bulletins 

You  can  format  bulletins  when  your  result  list  is  from  a  query  that  was 
for  Event  Parameters.  When  formatting  a  bulletin,  you  have  the 
option  of  displaying  the  bulletin  in  a  popup  window,  saving  the 
bulletin  to  a  file,  or  printing  the  bulletin. 


To  choose  a  subset  of  events  to  be  included  in  the  bulletin: 

1.  Click  on  Deselect  All  in  the  Result  List  window. 

2.  Select  the  first  4  events  in  the  list,  as  shown  below. 


•S&ifSSiHResuit 

File  Query  View  Data 

Download  Options  Send  j 

First  Event  Query} 

origin. etoh 

origin. lat  origin. Ion  j 

BCS/01/91  02:57:15.5  -26.5042  -177.5178 
0  05/01/91  03:01:02.4  -11.7271  -166.4709 
005/01/91  03:06:48.8  42.25B8  44.3989 
|B 05/01/91  03:38:12.0  42.5092 


43.7230 


005/01/91  04:39:06.7  -2.0415  120.8861 
aOS/Ol/91  05:13:37.4  42.5975  13.7733 


Select  All|  |Deselect  Ali| 


3.  Choose  Format  Bulletin  from  the  Data  menu. 
The  Format  Bulletin  window  will  appear. 


Output:  ^Displ^JnWindow^oJ 

Output  Format: 


ASCII 


Output  Filename  |j _ 

[Format  Bulletin  |  |  Cancel) 


To  display  a  bulletin  in  a  popup  window : 

4.  Click  the  Output  button  to  Display  in  Window. 

5.  Click  the  Output  Format  button  to  ASCII. 
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Formatting  Bulletins 


6.  Click  the  Format  Bulletin  button. 

After  a  short  period  of  time,  a  text  window  will  appear, 
containing  the  bulletin  for  the  selected  events. 


7.  When  you  are  done  browsing  the  bulletin,  click  Dismiss. 

To  write  the  bulletin  to  a  file: 

8.  Choose  Format  Bulletin  from  the  Data  menu. 

9.  Click  the  Output  button  to  Output  to  File. 

10.  Click  the  Output  Format  button  to  the  desired  format. 

The  Postscript  format  can  be  used  if  the  file  will  eventually  be 
sent  to  a  postscript  printer.  The  ASCII  format  produces  files 
which  are  readable  without  applying  any  post  processing,  and 
nroff/troff  options  produce  files  which  can  be  filtered  through  die 
standard  UNIX  typesetting  programs  to  produce  fomiattcd 
output.  If  you  are  not  sure  which  format  to  use,  you  should  select 
ASCII. 
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Formatting  Bulletins 


11.  Enter  the  name  of  the  hie  to  dump  to  into  the  Output 
Filename  held,  as  shown  below  (here,  we  have  used 
bulletin. gsett  as  the  filename). 


ormat  Bulletli 


Output: 

|  Output  to  File 

3 

Output  Format: 

ASCII  a 

Output  Filename 

bulletin. gset( 

| (Format  Bulletin!  (Cancel) 

12.  Click  the  Format  Bulletin  button. 

After  a  short  period  of  time,  the  Format  Bulletin  window  will 
disappear.  At  that  point,  the  file  will  have  been  created.  To  look  at 
the  file,  you  can  type  more  bulletin .  gsett . 

13.  Choose  Close  from  the  File  menu  of  the  Result  list. 

You  are  now  done  working  with  this  result  list.  In  the  next 
section,  we  will  perform  some  more  complicated  queries. 
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Predicted  Arrival  Times 

Often,  a  user  will  want  to  search  for  waveforms  in  a  database  account 
which  has  not  been  set  up  with  links  between  events  and  waveforms1 . 
In  this  case,  CenterView  can  search  the  database  for  waveforms 
which  overlap  a  time  window  determined  by  computing  theoretical 
travel  times2  for  the  desired  events. 

The  next  example  demonstrates  this  capability  by  searching  for 
waveforms  in  the  GSETT  database  account  for  an  event  on  May  29, 
1991. 

1.  Select  Clear  Query  from  the  Query  Menu  in  the 
CenterView  window. 

2.  Select  Event  Parameters  and  Waveforms  from  Data 
Types. 

3.  Enter  GSETT  in  the  Database  Accounts  field. 

Specify  event  information: 

4.  Select  By  Event  Time  from  Constraint  Types. 

5.  In  the  Event  Time  fields,  enter  5/29/91  18:00:00  and 
5/29/91  20:00:00. 

This  specifies  events  that  occurred  between  18:00  and  20:00  on 
May  29,  1991.  It  is  not  necessary  to  enter  times  that  will 
uniquely  specify  one  event.  CenterView  will  provide  a  list  of 
matching  events  before  performing  the  waveform  query. 

Specify  how  to  retrieve  the  waveforms,  given  the  event: 

We  are  interested  in  finding  all  waveforms  which  overlap  with  a 
time  window  beginning  30  seconds  before  the  theoretical  P 
arrival  time  and  120  seconds  after  the  theoretical  P  arrival  time. 

6.  Click  the  Waveform  Type  field  Online. 

7.  Enter  data  in  the  Phase  Type  W  indow  field,  Velocity  Window 
field,  and  Time  Buffer  field  as  shown  in  the  next  figure. 

The  Phase-Type  Window  and  Velocity  Window  specify  the  same 
infonnation  i.c.,  the  window  start  and  end  times  relative  to  the 
event.  If  minimum  or  maximum  values  arc  entered  in  both  the 
Phase  Type  Window  and  Velocity  Window  fields,  then  the  value 
entered  into  the  Velocity  Window  field  will  take  precedence. 


1 .  using  a  CSS  Version  3.0  wftag  table 

2.  currently  based  on  the  IASPE-9I  travel  time  curves 
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Predicted  Arrival  Times 


File  Query  View  Options  Customize 


Data  Types 

□  Detection  Parameters 

□  Station  Parameters 

B  Event  Parameters 

B  Waveforms 

Database  Accounts:  GSETTi 


□  By  Event  Author 

□  By  Geographic/Seismic  Region 

□  By  Event  Location 

□  By  Mb/Ms/MI 

□  By  Event  Magnitude 

□  By  Network/Station/Channel  Code 

B  By  Event  Time 

□  By  Number  of  Defining  Phases 

□  By  Event  Type 

□  By  Waveform  Time 

Waveform  Type: 
Waveform  Method: 
Phase  Type  Window: 
Velocity  Window: 
Time  Buffer: 

Station  Distance: 
Event  Time: 


Query  Parameters 
Online  a 

By  Predicted  Time  a] 


SCSfil  18:00:00 


to  _ 

to  I _ 

to  {120 
to  ! 

to  I'SCSBI  20:00.00 


8.  Select  Run  Query  from  the  Query  menu. 

An  Intermediate  Results  message  will  be  displayed. 


Predicted  Arrival  Times 


This  message  states  that  the  displayed  Result  List  is  not  the  final 
result  of  the  query.  Dismiss  this  window.  The  Results  List 
displays  all  events  (but  no  waveforms)  which  occurred  during 
the  specified  time.  From  this  Result  List  you  can  select  the 
events  for  which  you  want  waveforms.  It  is  best  to  keep  this  list 
small  since  waveform  retrieval  can  be  a  time-consuming 
process. 

For  this  example,  we  will  use  the  event  of  a  nuclear  blast  from 
the  Muraroa  test  site  which  occurred  at  19:00:00.8. 

9.  Deselect  ail  of  the  events  by  clicking  the  Deselect  All 
button. 

10.  Select  the  event  with  the  origin  time  19:00:00.8. 


;TTTOHff 


11.  Click  Resume  Query  in  the  Results  List  window. 

The  query  will  resume  execution.  After  a  brief  delay,  the  results 
will  be  displayed. 
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Predicted  Arrival  Times 


12.  Rename  the  result  list  to  First.  Waveform  Query. 

If  you  do  not  remember  how  to  rename  queries,  refer  to  the 
section  on  renaming  queries. 


Rte  Query  View  Data  Download  Options  Send 


First  Waveform  QuerJ 


wfdisc.sta  vfdisc.chan 


wf  .retoh 


wf . rendetoh 


B  AQU 

St 

OS/29/91 

19:19:17.6 

OS/29/91 

19:21:1' 

B  ARAO 

cb 

OS/29/91 

19:18:46.0 

05/29/91 

19:20:3! 

B  ARAO 

sz 

05/29/91 

19:13:46.0 

05/29/91 

19:20:3: 

B  AS1 2 

sz 

OS/29/91 

19:11:37.8 

05/29/91 

19:13:3 

B  ASAR 

cb 

OS/29/91 

19:11:37.5 

05/29/91 

19:13:3; 

b  gum! 

nc/QQ/Qi 

n^/oo/Qi 

IQ. 91  .1< 

[Select  All]  [Deselect  All| 


You  have  now  completed  this  query.  We  will  use  the  results  from 
this  query  in  a  later  section  on  dumping  waveforms. 

13.  Close  the  Result  List  window. 

14.  Close  any  remaining  result  list  windows. 
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More  Predicted  Arrival  Times 

Types  of  data  other  than  waveforms  can  be  retrieved  by  predicted 
arrival  times.  In  the  next  example,  predicted  arrival  times  are  used  to 
retrieve  detection  parameters.  In  these  queries,  the  user,  rather  than 
the  database,  supplies  the  events. 


1.  Create  a  file  containing  the  event  that  you  are  interested  in. 
Using  your  favorite  editor,  create  a  file  named  events  (the  file 
name  is  unimportant)  in  the  same  directory  that  you  started 
CenterView.  We  will  use  the  same  event  that  was  used  in  the 
previous  query.  An  event  file  can  contain  any  number  of  events. 
Each  line  in  the  event  file  denotes  a  new  event  and  should  contain 
a  latitude,  longitude,  depth  and  time,  |n  that  order.  The  time 
may  be  specified  in  either  epoch  time  or  human  readable  time. 
Any  extra  data  at  the  end  of  the  line  will  be  ignored,  therefore, 
you  can  use  CSS  3.0  origin  files. 

2.  Enter  the  following  line  into  the  newly  created  events  file  and 
save  it. 

-22.1093  -138.8229  0.0000  5/29/91  19:00:00 

3.  Since  we  are  interested  in  retrieving  detection  information, 
select  Detection  Parameters  from  the  list.  No  other  items 
should  be  selected. 


4.  Enter  GSETT  into  the  Select  Account  field. 


5.  Select  By  User  Event  File  from  the  Constraint  Type  list. 


6.  In  the  User  Event  File  field,  enter  the  pathname  for  the  newly- 
created  events  file.  Continue  entering  the  constraint 
information  as  follows: 


User  Event  File: 
Phase  Type  Window: 
Velocity  Window: 
Time  Buffer: 

Station  Distance: 


Query  Parameters 


|  ne/gymerflerraro/event^ 

jP 

to 

i 

to 

20 

I-io 

to 

TO 

I 

to 

For  this  query  we  will  select  detections  that  arrived  within  10 
seconds  of  the  predicted  arrival  time  of  the  P  phase.  CenterView 
will  use  the  event  in  the  newly-created  file. 
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More  Predicted  Arrival  Times 


FHe  Query  View  Options  Customize 


Data  Types 

S  Detection  Parameters 

□  Station  Parameters 

□  Event  Parameters 

□  Waveforms 

Database  Accounts: 


Constraint  Types 


□  By  Arrival  Author 

□  By  Phase  Name 

□  By  Detection  Time 

□  By  Station-Event  Azimuth 

□  By  Event-Station  Azimuth 

B  By  User  Event  File 

□  By  Network/StationfChannel  Code 

User  Event  File: 

Phase  Type  Window: 
Velocity  Window:  jj~ 

Time  Buffer:  f  ■- 

Station  Distance:  ■' 


Query  Parameters 
ne/gymer/ferarro/event  j  I 


to  [ 
to  1*2.0 


7.  Select  Run  Query. 

Intermediate  results  will  not  be  displayed  since  you  have  supplied 
CenterView  with  the  exact  list  of  events  in  which  you  are 
interested.  When  the  query  has  finished  running,  the  Result  List 
will  be  displayed. 


Dumping  Query  Results 


I 

I 

I 

I 


Dumping  Query  Results 

Query  results  can  be  dumped  to  CSS  3.0  format  files  or  the  columns 
displayed  on  the  screen  can  be  dumped  to  disk.  The  following 
example  demonstrates  the  different  methods  by  which  results  can  be 
dumped. 

Dump  the  results  in  CSS  Version  3.0  Format: 

1.  Choose  Download  to  Flat  Fites  from  the  Download  menu  in 
the  Result  List 

The  Result  List  (as  you  see  it)  is  dumped  to  a  file.  The  Dump  to 
Flat  Files  window  will  display  a  list  of  all  tables  that  can  be 
dumped  from  the  current  query. 


2.  Select  arrival  and  enter  myf  ile  (or  any  filename  prefix)  into 
the  Dir/File  Prefix  field. 

This  string  will  be  used  to  create  one  file  named  myfile.arrival. 

3.  Click  the  Dump  button. 

CenterView  will  dump  the  data  to  CSS  3.0  format  and  will 
display  a  window  describing  how  many  rows  were  dumped  and 
to  which  files. 


ISSUES  ■  ■  -  | 


Dumped  107  arrival  records  to  /home/gymerfferraro/mylile. arrival. 
Djsmissj 

4.  Dismiss  the  Data  Dumped  window. 

5.  Hide  the  Dump  To  Flat  Files  window. 

Dump  the  results  as  they  appear  in  the  Result  List  window: 

6.  Select  Download  Results  from  the  Download  menu. 

7.  Click  Yes  in  the  Include  Header  field. 
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M 

aEEtmE  ■  i 

File  Name: 

lfhome/gymerfferraro/myflle2 

Delimiter: 

Tab  Delimited  cs 

Include  Header: 

lYeS°i 

|Dump|  [Hide] 

8.  Click  the  Dump  button. 

The  result  list,  as  displayed  in  the  Result  List  window,  will  be 
output  into  the  named  file. 
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Sending  Results  to  the  Map 

CenterView  can  send  query  results  to  other  programs.  For  example, 
station,  event  and  detection  data  can  be  sent  to  the  Map  program  and 
waveform  data  can  be  sent  to  the  geotool  program. 

To  send  data  to  other  programs,  ISIS,  the  CommAgent,  and  the 
destination  program  (Map  or  geotool)  must  be  running.  Refer  to 
Appendix  A  for  instruct'  )ns  for  starting  these  processes. 

In  this  exampu  e  will  send  CenterView  query  results  to  the  Map 
program.  NOTE:  The  Map  program  requires  a  color  display. 

1.  Make  sure  that  ISIS  and  the  CommAgent  are  running. 

2.  In  CenterView,  select  Connect  to  Agent  from  the  File  menu 
in  the  main  CenterView  window. 


Agent  Name: 

Chrisie 

ISIS  Port: 

164^ 

IB3B 

3.  Enter  the  Agent  Name  and  ISIS  Port  in  the  appropriate  fields. 

4.  Click  the  Connect  button. 

5.  Perform  a  simple  event  query. 

In  this  example,  we’ve  used  the  query  from  section  A,  except 
we’ve  restricted  the  Event  Magnitude  field  to  be  from  4  to  4.1. 
(By  further  restricting  the  results,  we  are  reducing  the  amount  of 
data  sent  to  the  map).  To  see  the  number  of  results  generated, 
select  Result  Count  under  the  Data  menu  in  the  Results  List. 


Send  the  query  results  to  the  Map  program: 

6.  Run  the  Map  program. 

7.  Select  Map  Options  from  the  Results  List  Options  menu. 

The  Map  Options  window  will  appear.  Use  this  window  to 
specify  which  data  should  be  sent  to  the  map. 
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Destination 


: 


Map  Data  Types 


S  Event  Locations  □  Event  Error  Ellipses 


Event  Locations 

Symbol: 

S 

Size 
Color: 


point  i 


White 


| Update)  |Send|  [Hide) 


8.  Choose  your  favorite  color  and  enter  it  in  the  Event  Color 
field  (for  this  example,  we  use  white). 

9.  Click  Send  to  send  the  results  to  the  Map  program. 

The  events  from  the  working  query  will  be  displayed  on  the  map. 

10.  Close  the  Result  List  window. 
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Sending  Results  to  geotool 

When  a  result  list  contains  online  waveforms,  CenterView  can  send 
these  waveforms  to  geotool.  As  with  sending  to  the  Map  program, 
you  must  first  make  sure  that  interprocess  communications  are 
initialized  properly  (see  section  15  on  Sending  Results  to  the  Map). 

For  this  example,  we  will  use  the  results  from  the  first  waveform 
query  in  this  tutorial. 

Display  the  results  from  the  previous  query 

1.  Choose  Results  List  from  the  View  menu. 


□  First  Event  Query 

□  Result  Ust#Z 

□  Result  List  #3 
O  Result  List  #4 


First  Waveform  Query 


□  Result  List  #6 

□  Result  List  #7 


0 


2.  Click  on  First  Waveform  Query. 

3.  Click  on  Display. 

The  result  list  will  be  displayed. 


esutt  Lis 


File  Query  View  Data  Download  Options  Send 


First  Wavelorm  Query} 


vfdisc.sta  vfdisc.chan  vf.retoh 


B  AQU 

sz 

B  ARA0 

cb 

B  ARA0 

sz 

B  AS1  2 

sz 

B  ASAR 

cb 

vf.retoh  vf.rendetoh 


05/29/91  19:19:17.6  05/29/91  19:21:1 
05/29/91  19:18:46.0  05/29/91  19:20:3 
05/29/91  19:18:46.0  05/29/91  19:20:3 
05/29/91  19:11:37.8  05/29/91  19:13:3 
05/29/91  19:11:37.5  05/29/91  19:13:3 


4.  Run  the  geotool  program  (see  Appendix  B  for  more 
information  on  running  geotool). 
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I 


5.  Select  a  small  number  of  rows  from  the  result  list. 

6.  Select  Send  to  geotool  from  the  Send  menu. 

After  a  short  time,  the  waveforms  will  appear  in  the  geotool 
window. 
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Dumping  Waveform  Data 

One  of  the  most  commonly  used  (and  abused)  features  of  Center  View 
is  the  dumping  of  waveform  data  to  disk.  Both  online  data  on 
mounted  file  systems  and  offline  data  (on  tapes  referenced  in  the 
wftape  records  in  the  database)  can  be  dumped.  Since  the  retrieval  of 
offline  data  from  tape  requires  operator  intervention,  it  is  more  time- 
consuming  than  online  waveform  dumping  and  should  always  be 
considered  carefully. 


For  this  example,  we  will  use  the  same  result  list  that  was  chosen  in 
the  previous  section.  If  you  skipped  section  16  on  Sending  to 
Geotool,  please  perform  steps  1  -  3  from  that  section  to  select  the 
necessary  result  list. 

1.  Click  Select  All  in  the  Result  List  window,  to  make  sure  that 
all  the  waveforms  are  selected.. 


File  Query  View  Data  Download  Options  Sena 


First  Waveform  Querj 


wfdisc.sta  wfdisc.chan 


wf . retoh 


wf . rendetoh 


E  AQU 

SZ 

05/29/91 

19:19:17.6 

05/29/91 

19:21 : 1 

E  ARAO 

cb 

05/29/91 

19:18:46.0 

05/29/91 

19:20:31 

E  ARAO 

sz 

05/29/91 

19:18:46.0 

05/29/91 

19:20:31 

E  AS12 

sz 

05/29/91 

19:11:37.8 

05/29/91 

19:13:3 

0  ASAR 

cb 

05/29/91 

19:11: 17.5 

05/29/91 

19:13:3! 

D  cv  mi 

ns/?q/qi 

IQ'lfl'/lQ  9 

p: 


| Select  All |  | Deselect  All| 


2.  Select  Download  Waveforms  from  the  Download  menu  in 
the  Result  List  window. 

A  Download  Waveforms  window  will  be  displayed. 

This  window  allows  the  user  to  specify  how  die  waveforms 
should  be  dumped.  The  User  Name  field  should  contain  die  user 
name  to  which  mail  will  be  sent  upon  completion  of  the 
waveform  dump. 
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We  will  use  the  default  values  for  each  of  these  fields  which  will 
give  the  waveform  files  a  prefix  of  dump  and  will  place  a 
subdirectory  in  solt/itch  on  sol. 

3.  Click  the  No  Conversion  button  to  On. 

CenterView  will  leave  the  waveforms  in  the  format  that  they  were 
originally  stored.  Note:  In  most  cases,  you  will  want  to  convert 
the  waveforms  to  a  format  that  will  be  useful  on  the  machines  you 
work  on. 

4.  Click  the  Download  button. 

A  Waveform  Job  Submitted  window  will  be  displayed.  This 
window  shows  the  job  number  and  the  name  of  the  directory 
where  the  waveforms  have  been  dumped.  In  this  example,  the  job 
number  is  11954  and  the  directory  is  /itch/WaveformJob.l  1954. 
The  message  also  states  that  mail  will  be  sent  upon  job 
completion. 


Dumping  Waveform  Data 


5.  Click  the  Dismiss  button. 

After  a  brief  delay  a  mail  message  will  be  delivered. 


Your  waveform  request  has  finished  at  Tue  Jul  20  10:55:34  EDT  1993 
The  data  has  been  placed  on  sol 

in  the  directory:  /nfs/ndegei/var/tmp/WaveformJob. 11954 
A  copy  of  the  output  log  can  be  found  in  the  above  directory 
in  the  file:  data.log 


For  the  rest  of  this  example,  you  will  need  to  substitute  your  job 

number  for  the  job  number  of  this  example,  11954. 

6.  rlogin  to  sol  and  go  to  the  dumping  directory  by  typing: 

cd  /itch/Wavef ormJob. 11954 

7.  To  get  a  listing  of  the  files  that  have  been  created,  type  Is. 

In  this  directory,  you  will  find  three  types  of  files. 

(1)  The  first  type  is  the  wfdisc  file.  There  should  be  a  file  called 
data.wfdisc.  This  file  contains  CSS  Version  3.0  wfdisc 
records  for  the  data  that  were  dumped. 

(2)  The  second  type  of  file  in  the  directory  is  the  waveform  file. 
This  file  will  be  named  data.w.  If  a  Waveform  Method  other 
than  One  Waveform  File  is  chosen,  then  more  than  one  file 
will  be  created,  with  names  like  data.XXX.w,  where  XXX  is 
the  wfid  or  station  for  the  wfdiscs  contained  in  the  file. 

(3)  Finally,  there  is  a  log  file,  which  contains  some  information 
about  how  the  dump  was  done. 

8.  Click  Hide  in  the  Download  Waveforms  window. 

9.  Close  the  Result  List  window. 
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A  More  Complicated  Example 

To  illustrate  some  advanced  features  of  CenterView,  the  next  example 
will  locate  an  event  in  one  database  account  and  search  for  matching 
waveforms  in  another  account. 


We  will  begin  by  searching  for  the  Soviet  nuclear  test  that  occurred 
on  October  24,  1991.  We  will  search  for  this  event  in  the 
EXPLOSION  database  account. 

1.  Clear  Query. 

2.  Select  Event  Parameters  from  the  Data  Types  list. 

3.  Enter  EXPLOSION  into  the  Database  Accounts  field. 

4.  Since  we  know  the  date  of  the  test,  select  the  By  Event  Time 
constraint  type. 

5.  Enter  10/24/90  and  10/25/90  into  the  Event  Time  fields. 


File  Query  View  Options  Customize 


Data  Types 


□  Detection  Parameters  □  Station  Parameters 

S  Event  Parameters  □  Waveforms 

Oatabase  Accounts: 

EXPLOSION 

Constraint  Types 

□  By  Event  Author 

□  By  Event  Type 

□  By  Event  Location 

□  By  Geographic/Seismic  Region 

□  By  Event  Magnitude 

□  By  Mb/Ms/MI 

@  By  Event  Time 

□  By  Number  of  Defining  Phases 

Query  Parameters 


Event  Time: 


10/24SO 


to 


il  0/25/90 


6.  Select  Run  Query  from  the  Query  menu. 

The  Result  List  displays  the  queried  events  from  the 
EXPLOSION  database. 
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7.  Select  only  the  first  event  from  the  Result  List. 


File  Query  I iiew  Date  Download  Options  Send 


Result  List  * 8 

origin. etoh 


origin. lat  origin. Ion 


E  10/24/90  14:57:57.5  73.4100  54.7400 

!□  10/24/90  14:57:58.1  73.3610  54.7070| 


Select  Allj  [Deselect  An| 


To  continue  the  query,  we  will  search  for  waveforms  in  the  USSR 
database  account,  using  predicted  arrival  times. 

8.  Choose  Continue  Query  from  the  Result  List  Query  menu. 
The  Continue  Query  window  is  displayed. 

Since  we  are  interested  in  retrieving  waveforms  from  the  USSR 
account  for  this  event, 

9.  Select  Waveforms  from  the  list  of  Data  Types. 

10.  Enter  USSR  into  the  Database  Accounts  field. 

Any  new  information  which  was  not  retrieved  in  the  original 
query  will  be  retrieved  from  the  USSR  account 

Since  the  event  information  was  retrieved  in  the  previous  query 
from  the  EXPLOSION  account,  it  will  continue  to  be  accessed 
from  the  EXPLOSION  account,  not  the  USSR  account. 

Since  waveforms  were  not  retrieved  in  the  previous  query,  they 
will  be  retrieved  from  the  newly  specified  account,  USSR. 
Whenever  waveforms  are  retrieved  from  a  different  account  than 
events,  it  is  usually  necessary  to  specify  that  either  Predicted 
Times  or  Associated  Arrivals  be  used  as  the  waveform  retrieval 
method. 

11.  Click  the  Waveform  Method  field  to  By  Predicted  Time. 

12.  Enter  the  values  as  shown  in  the  next  figure. 

We  will  assume  that  we  are  only  interested  in  waveform  segments 
that  begin  30  seconds  before  the  theoretical  P  arrival  time,  and 
end  1 20  seconds  after  the  theoretical  P  arrival  time. 
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Data  Types 


□  Detection  Parameters 

□  Station  Parameters 

H  Event  Parameters 

H  Waveforms 

Database  Accounts: 


USSR} 


Constraint  Types 


□  By  Event  Author 

□  By  Event  Location 

□  By  Event  Magnitude 

□  By  Event  Name 

□  By  Event  Time 

n  n..  r— ni  _ 


□  By  GeographiciSeismic  Region 

□  By  Mb/Ms/MI 

□  By  NetworkfStation/Channel  Code 

□  By  Number  of  Defining  Phases 

□  By  Waveform  Time 


Waveform  Type: 
Waveform  Method: 
Phase  Type  Window: 
Velocity  Window: 
Time  Buffer: 

Station  Distance: 


Offline 


Query  Parameters 

] 


By  Predicted  Time 


ip 

to 

Pi 

I 

to 

I 

f-30 

to 

flZO 

i 

to 

1 

13.  Click  the  Waveform  Type  button  Offline. 

The  USSR  database  does  not  contain  any  online  waveforms  so  all 
of  the  waveforms  we  will  be  searching  for  are  offline. 

14.  Choose  Run  Query  from  the  Query  menu. 

At  this  point,  you  may  refer  to  your  scheme  window  to  see  the 
query  that  is  being  executed. 


Executing  SQL  for  query-1 Z: 


CREATE  TABLE  TMP_11214  AS 

SELECT  DISTINCT  tharr.thid  center_tharr_thid, 
wftape.wfid  USSR_wf tape_wf id, 

TMP_11212.USSR_site_sta  USSR_site_sta,  '¥'  SELECTED 

FROM  USSR. wf tape  wftape, 

center. TMP_1 121 2  TMP_I1212, 
center.TMP_11210  TMP_11210, 
center. TMP  11213  tharr 

WHERE  wftape.endtime  BETWEEN  tharr . mint ime  AND  ( tharr . mint ime  +  86400.0)  and 
wftape.tlme  BETWEEN  (tharr . maxt ime  -  86400.0)  AND  tharr. maxtime  and 
TMP_11212.USSR_site_sta  -  wftape.sta  and 
TMP_i 1210. EXPLOS ION_or igin_or id  -  tharr. orid  and 
TMP_1 121 2 .USSR_s i te_sta  *  tharr. sta  and 
wf tape . sta | | '  -  tharr. sta  and 
TMP_1 121 2. selected  -  'V'  and 
TMP  11210. selected  -  ' ¥' 
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After  a  brief  delay,  the  Results  List  will  be  displayed. 


FHe  Query  View  Data  Download  Options  Send 


Result  List  #10 

site.sta  site.lat  site. Ion  wftape.sta  wf tape. chan_ wf . retoj 


|B  aru 

56.4000 

58.6000  ARU 

se 

10/24/90 

B  ARU 

56.4000 

58.6000  ARU 

sn 

10/24/90 

B  ARU 

56.4000 

58.6000  ARU 

sz 

10/24/90 

B  ARU 

56.4000 

58.6000  ARU 

ve 

10/24/90 

B  ARU 

56.4000 

58.6000  ARU 

vn 

10/24/90 

.gt.APII  ■ 

jurnn . 

An nn  ion 

- 

i  n  /'ja  /on 

P0 


[Select  All)  [Deselect  aH] 


Like  the  previous  waveform  query,  the  waveforms  in  this  result  list 
can  also  be  downloaded.  Generally,  dumping  offline  waveforms  takes 
longer  than  dumping  online  waveforms  because  it  requires  operators 
to  search  for  and  mount  tapes.  Requests  for  offline  waveforms  should 
thus  be  given  careful  consideration  before  dumping. 

15,  Close  the  Result  List  window. 

You  have  now  completed  the  last  query  in  the  tutorial. 
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Exiting  CenterView 

You  have  now  completed  the  CenterView  tutorial.  To  exit: 

1.  Choose  Exit  from  the  File  menu. 

2.  The  Confirm  Exit  window  is  displayed. 


tfyou  really  want  to  exit  then  press  'Confirm'. 
Otherwise,  press  'Dismiss*. 


| Confirm |  |pismlss[ 


3.  Click  Confirm  in  this  window. 

CenterView  will  shut  down  after  removing  any  temporary  tables 
created  during  the  session. 
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Helpful  Hints 

We  hope  that  the  following  helpful  hints  can  make  your  CenterView 

sessions  more  productive. 

Help  for  all  text  fields  in  CenterView  can  be  received  by  typing 
the  <F1>  key  after  clicking  in  the  field.  For  some  fields,  if  there 
is  text  present  in  the  field,  typing  <F1>  will  produce  a  list  of 
possible  choices.  In  most  other  cases,  a  simple  explanation  of 
the  field  will  be  presented.  NOTE:  On  some  machines,  it  may 
be  necessary  to  substitute  the  <Help>  key  for  <F1>. 

When  performing  waveform  queries  based  on  theoretical 
arrival  times,  it  is  better  to  use  small  sets  of  events  and  stations. 
CenterView  must  compute  theoretical  arrival  times  at  each 
station  for  each  event.  If  you  are  looking  for  waveforms  at 
5,000  stations  for  100  events,  it  could  result  in  up  to  500,000 
possible  time  segments  which  must  be  compared  to  the  wfdisc 
table.  A  query  of  this  magnitude  could  take  a  very  long  time.  If 
there  is  a  specific  list  of  stations  that  you  are  interested  in,  it  is  a 
good  idea  to  constrain  the  query  by  station  also,  and  enter  the 
list  of  stations.  This  will  greatly  reduce  the  amount  of  work 
involved  in  running  the  query. 

Be  aware  that  queries  based  on  predicted  arrival  times  in  the 
ISC,  EVENTS,  EXPLOSION,  and  NUCLEAR  accounts  on 
hugo  may  take  a  considerable  amount  of  time,  as  each  account 
contains  a  very  large  number  of  stations. 

w  Pay  careful  attention  when  CenterView  displays  a  window 
warning  you  that  no  tight  constraints  have  been  specified.  Quite 
often,  the  query  can  be  constrained  in  a  way  that  will  be  much 
more  useful  to  the  user. 
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Interprocess  Communication 

Center  View  can  use  interprocess  communication  to  send  data  to  other 
programs,  including  the  Map  program  and  geotool.  Before 
CenterView  can  send  data,  the  interprocess  communications  software 
must  be  initialized.  To  insure  that  this  software  has  been  initialized, 
execute  the  following  commands. 


1.  Type  source  ~nmrd/rel/bin/start._ipc  (if  you  are 
running  ksh  as  your  shell,  type  .  -nmrd/rel/bin/ 
start_ipc .  ksh). 

ISIS  is  a  program  that  needs  to  be  running  on  the  machine  in 
order  for  interprocess  communication  to  work.  If  ISIS  is  not 
running,  you  will  be  notified,  and  you  will  need  to  contact  staff  at 
the  Center  to  start  it. 

2.  When  prompted  for  the  agent  name,  enter  your  login  name. 

If  ISIS  is  running,  then  you  will  be  prompted  for  an  agent  name. 
The  agent  name  is  a  name  that  is  given  to  all  processes  that  you 
run,  and  is  unique  for  each  user.  Usually,  people  use  their  login 
names  as  their  agent  names 

After  entering  the  agent  name,  the  script  will  start  a  process 
called  CommAgent,  which  facilitates  the  delivery  of  messages 
between  programs.  The  script  also  sets  two  environment 
variables,  AESIRHOST  and  ISISPORT. 

If  you  wish  to  learn  more  about  the  interprocess  communication 
layer,  you  can  look  at  the  manpage  for  CommAgent. 

3.  If  you  wish  to  run  the  Map  program,  type  runMap. 

In  order  to  run  the  Map  program,  you  must  be  using  a  color 
display,  and  your  DISPLAY  environment  variable  must  be  set 
correctly. 

4.  If  you  wish  to  run  geotool,  type  run_geotool  -a  &. 

Like  the  map  program,  it  is  necessary  to  have  a  properly  set 
DISPLAY  environment  variable. 

If  you  have  any  trouble  starting  any  of  these  processes,  someone  on 
the  Center’s  Geophysical  Systems  and  Support  staff  can  help  you. 
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